home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 18 / q18.d81 / t.autopro boot < prev    next >
Text File  |  2022-08-28  |  11KB  |  201 lines
  1.  
  2.                        A U T O P R O   8 0    M O D 3.5
  3.  
  4.                     by Jane M. Voskamp  of South Australia
  5.  
  6.      The world can be divided into two types of people; those who divide the
  7. world into two types of people and those who don't.  In this case I'm
  8. dividing the world into beginners and non-beginners because we have a
  9. program for each.  Jane Voskamp's AUTOPRO 80 is a program for beginners.  On
  10. this same issue we have MAGIC 128 by e. g. bell which is for those who are
  11. comfortable with Commodore DOS and want raw power.
  12.  
  13.      The main feature of AUTOPRO 80 is the Autoboot Track Creation and
  14. Protection.  On the disk that came with your C-128 is a small program called
  15. "autoboot maker" that writes code on Track 1 Sector 0 of a disk.  You enter
  16. the name of the file you want booted and this disk will now "autoboot",
  17. meaning that when you turn on (or reset) your computer with this disk in the
  18. drive, the file is automatically booted.
  19.  
  20.      The only problem is that the sector is not firmly "allocated" by the
  21. BAM (Block Allocation Map).  If you do a "collect" (or as it is commonly
  22. known, "validate") on that disk, the sector becomes "de-allocated" and any
  23. file saved on that disk can overwrite that sector.  This means, no more
  24. autoboot.  Worse, if you try to redo the Autoboot on that disk, it will
  25. overwrite the file that overwrote it!  Goodbye, file!
  26.  
  27.      AUTOPRO 80 gets around this altogether by first checking if the boot
  28. sector is used.  If it is used, the program will de-allocate the sector, and
  29. continue the collect.  When the collect is complete, the routine
  30. re-allocates the boot sector, and because it is protected in the BAM with
  31. the Protect (USR) file in the Directory, it can never be accidentally
  32. written over.  AUTOPRO 80 even checks for Boot sectors on older disks that
  33. don't have the protect file, and allocates them correctly.
  34.  
  35.      But AUTOPRO 80 is more than just an improved Autoboot maker.  It also
  36. provides a friendly atmosphere for performing DOS commands like SCRATCH,
  37. RENAME, FORMAT, and for changing drives.  All AUTOPRO 80 routines will work
  38. on 1541, 1571 and 1581 disk drives, as device 8 through 16.
  39.  
  40.      This program uses Jon Mattson's CONTROL 80 (from LS 128 #10) which
  41. makes things like storing and recalling screens easy.  Because of CONTROL
  42. 80, AUTOPRO 80 is very "windowy".  Jane's text, which follows, explains
  43. everything in detail.
  44.  
  45.    The Main Menu
  46.    -------------
  47.  
  48.       F1 - Directory                F2 - Collect BootDisk
  49.       F3 - Rename File              F4 - Scratch File
  50.       F5 - Protect Boot             F6 - Make AutoBoot
  51.       F7 - Format Disk              F8 - Exit AUTOPRO 80
  52.     C=F1 - Change Device#         C=F3 - Device Mode 71/41
  53.  
  54.      After an option has finished, or you've exited the routine, a Status
  55. Report window is displayed.  If no operation has been performed, or the
  56. Status is 'OK', the window will disappear with a beep.  If there has been an
  57. error, or any problems during the routine selected, the Error Message and 
  58. DOS (Disk Operating System) status are shown.  You are prompted to check
  59. your disk (write protected, disk missing, drive door not closed, etc.), 
  60. then press any key to get a new Status and Exit to the Menu.  The routines
  61. contain extensive error checking for possible problems.
  62.  
  63.      All the options are easy to use, and most have self-contained
  64. instructions, options or Exits to the Menu.  At almost any prompt that asks
  65. for input, if you just press RETURN without entering anything, you'll be
  66. taken back to the Main Menu and the Status Box displayed.
  67.  
  68.   F1 - Directory
  69.  
  70.      This simply displays the directory of the disk in the current drive. 
  71. To stop a long directory from scrolling out of sight, press NO SCROLL.
  72.  
  73.   F2 - Collect BootDisk  (Also known as Validate)
  74.  
  75.      On accessing this option, a warning is displayed in the window.  Do not
  76. Collect a disk with GEOS files on it, or the File Header Block (Icons), 
  77. Off-Page Directory and Index Table pointers will be destroyed.  Disks with
  78. GEOS files on them should only be validated with GEOS itself.
  79.  
  80.      Anything that could be destructive in AUTOPRO 80 displays a (y/n)
  81. prompt first.  To back out, just press N.  If you press Y, the program will 
  82. first check for the current device mode, 1541 or 1571.  If the device is in
  83. 1541 mode, you are cautioned against collecting a 1571 disk in 1541 mode. 
  84. You could lose files by doing that.  The prompt only shows if you have a
  85. 1571 disk drive, and is bypassed altogether with a 1581.
  86.  
  87.      The program will then check for an Autoboot on Track 1, Sector 0.  If
  88. none is found, a normal Collect is performed and when done, the program
  89. closes the window and displays the Status Report window and the Menu.  If an
  90. error occurs, the Collect will abort and the Status Report window, the Error
  91. message and DOS Status will be displayed.
  92.  
  93.      If the disk does contain an autoboot track the program will first
  94. disable the boot sequence, then perform the Collect or Validate, and when
  95. done, re-enable the boot sequence.  Then it's back to the Menu.
  96.  
  97.      One possible problem that could occur during the collect is that after
  98. disabling the Autoboot sequence, the collect encounters corrupted sectors on
  99. the disk and aborts the collect without continuing through the re-enable
  100. Autoboot sequence.  The window will close and the Status Report window will
  101. be displayed with error messages.  In that case your disk will no longer
  102. autoboot.  If this should happen, use F6 (Make AutoBoot) to display the name
  103. of the file, and then replace the boot track.
  104.  
  105.   F3  -  Rename File
  106.  
  107.      Enter the filename of the file to be renamed (up to 16 characters) and
  108. press RETURN.  Then enter the new name for the file (up to 16 characters),
  109. and press RETURN.  When the rename is completed, the directory is
  110. automatically displayed on screen.  If an error is detected during renaming,
  111. the program aborts, closes the window and displays the Status Report window,
  112. the Error message and DOS Status.
  113.  
  114.   F4 - Scratch File
  115.  
  116.      If you don't remember the name of the file you want to scratch, enter $
  117. (SHIFT-4) for the directory.  Otherwise, enter the filename to be scratched
  118. (up to 16 characters).  When a scratch is completed, the directory is
  119. automatically displayed on screen.
  120.  
  121.   F5  -  Protect Boot
  122.  
  123.      This option protects the Autoboot Sector by creating a User (USR) file
  124. called "protect", and allocating Track 1 Sector 0 to it on the BAM.  1541
  125. users should use the F6 (Make AutoBoot) before using protect.  If the
  126. protect file is not the first file on the directory, the routine will abort
  127. to the Status Report window and the Menu.  However, when the USR file is
  128. written and allocated to Track 1 Sector 0, the collect routine is called,
  129. which will check for an Autoboot Sector before commencing.  As usual, when
  130. completed, the Directory is automatically displayed on screen.
  131.  
  132.   F6  -  Make Autoboot
  133.  
  134.      On accessing this option, a warning is displayed in the window.  Any
  135. data stored on Track 1 Sector 0 will be over-written and lost during this
  136. process.  At the (y/n) prompt, to back out, just press N.  You can make
  137. Autoboots for Machine Language programs or for BASIC programs.  In the case
  138. of ML programs the command BOOT is written in the boot sequence with the
  139. program name.  For BASIC programs RUN is written instead.  If you press Y at
  140. the prompt, the program will first check for an existing boot track, and
  141. then the BAM for any allocation of Track 1 Sector 0.  Which means you can
  142. create boot tracks on older disks as well.  If an autoboot track or a
  143. disabled autoboot track exists, the filename is displayed in the window.  At
  144. either of the (y/n) prompts, you can back out.  If another program occupies
  145. the sector then you are warned by a message.  At the (y/n) prompt you should
  146. select N to exit so as not to overwrite an existing program in this case.
  147.  
  148.      If all is well, the program then prompts you to enter the name of the
  149. program (up to 16 characters) to be autobooted.  Do not use punctuation such
  150. as a colon, a semi-colon or a comma.  The program then asks you to enter M
  151. for machine language or B for BASIC.  The next window allows you to enter
  152. the boot disk unit number from 8